home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / anzeigeprogramme / fastview / fastview.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  42KB  |  750 lines

  1. @database FastView.guide
  2. @author "John Hendrikx"
  3. @(c) "Copyright 
  4.  1995 John Hendrikx"
  5. @$VER: FastView.guide 2.0 (24.10.95)
  6. @node Main "FastView Help"
  7.                         @{b}FastView 2.0@{ub}
  8.               Copyright 
  9.  1994, 1995, John Hendrikx
  10.                        All rights reserved
  11.                   Release date 24 October 1995
  12.                             SHAREWARE
  13.                            User Manual
  14.     @{" Introduction         " link Introduction} What can I do with FastView?
  15.     @{" Feature List         " link Features} What features does FastView have?
  16.     @{" Requirements         " link Requirements} Will it run on my system?
  17.     @{" Installation         " link Install} How do I install FastView?
  18.     @{" Registration         " link Registration} How should I register FastView?
  19.     @{" Usage from the Shell " link UsageCLI} How do I use FastView from the Shell?
  20.     @{" Usage from Workbench " link UsageWB} How do I use FastView from Workbench?
  21.     @{" Keyboard control     " link Keyboard} How to control FastView with the keyboard.
  22.     @{" Configuring FastView " link Config} Creating a config-file for FastView.
  23.     @{" Common problems      " link Problems} Common questions and their answers.
  24.     @{" Future               " link Future} What the future will bring...
  25.     @{" Known bugs           " link Bugs} Things I should know...
  26.     @{" How to reach me      " link About} How can I reach the author?
  27.     @{" Acknowledgements     " link Ack} Who does the author want to thank?
  28.     @{" History              " link History} What's new in this version?
  29. @endnode
  30. @node Introduction "FastView: Introduction"
  31. FastView is a program which shows IFF, GIF, BMP, PCX and JPEG (*)
  32. pictures on your screen.  Of course many programs exist for this
  33. task, but this one is special because it is very fast and was
  34. designed with both OCS/ECS and AGA users in mind.  For example:
  35. FastView can show HAM8 and IFF 24-bit pictures on OCS/ECS machines
  36. in HAM which was one of the things I missed in all the other
  37. viewing programs I've seen.
  38. This is also the ideal viewer when you've got large collections
  39. of pictures which need to be sorted out.  FastView allows you to
  40. delete pictures while viewing them and you can even define your
  41. own command to for example copy a picture to your RAM disk at
  42. the touch of a button.
  43. (*) JPEG pictures are shown using the Tower JPEG Codec Class by
  44.     Christoph Feck.
  45. @{b}COPYRIGHT NOTICE@{ub}
  46. FastView software and documentation are Copyright (C) 1995 by John
  47. Hendrikx.  All rights reserved.
  48. The JPEG codec is Copyright (C) 1994 Christoph Feck,
  49. TowerSystems.  All Rights Reserved.  It is based in part on the
  50. work of the Independent JPEG Group.
  51. @{b}DISCLAIMER@{ub}
  52. FastView has proven to be stable in everyday use. @{"The author" link About}
  53. is not responsible for any loss of data, damages to software or
  54. hardware that may result directly or indirectly from the use of this
  55. program.  The author reserves the right to make changes to the
  56. software or documentation without notice.
  57. The JPEG codec is provided "AS-IS" and subject to change without
  58. prior notice; no warranties are made.  All use is at your own risk.
  59. No liability or responsibility is assumed.
  60. @{b}PREFACE@{ub}
  61. This program is shareware, it is *not* public domain.  This means
  62. that if you use this program longer than a period of two weeks
  63. you'll have to send @{"The author" link About} 20 DM, HFL 20, 10 UK Pounds
  64. or 15 US Dollars to become a registered user.  See @{"Registration" link Registration} for more
  65. details.
  66. None of the files of the FastView package may be modified or left
  67. out without permission of the author.  Crunching or archiving is
  68. allowed only if none of the FastView files get modified by it.
  69. FastView may be distributed freely in public domain collections
  70. such as Fred Fish's Amiga Library.  You may charge a fee to
  71. recover distribution costs.  The fee for diskette distribution
  72. may not be more than the cost to obtain a public domain diskette
  73. from Fred Fish.
  74. @endnode
  75. @node Features "FastView: Features"
  76.  - FastView can display most types of IFF ILBM, GIF, PCX, JPEG and BMP
  77.    pictures.  Pictures which normally can't directly be displayed on
  78.    your Amiga will be converted to HAM or optionally to a Gray-scale
  79.    picture.
  80.  - AmigaDOS patterns (wildcards) fully supported.
  81.  - Runs from the @{"Shell" link UsageCLI} and @{"Workbench" link UsageWB}.
  82.  - FastView can optionally @{"dither" link Dither} your pictures to improve their quality.
  83.  - If multiple pictures were selected FastView will optionally load
  84.    and decode the next picture(s) while you're still viewing the first
  85.    one.  The number of pictures which FastView can pre-load and decode is
  86.    only limited by available memory (this also works with Virtual memory
  87.    programs like VMM and GigaMem).
  88.  - Optional (down) @{"scaling" link Scale} of pictures to fit screen.  This works for
  89.    all types of pictures, but it may produce ugly results when applied
  90.    to HAM pictures.
  91.  - On OCS/ECS machines FastView tries to recognize pictures with a
  92.    Black & White palette and will display these in a normal mode instead
  93.    of using HAM.
  94.  - FastView has the ability to pick an ideal set of colors for pictures
  95.    rendered to HAM6 or HAM8.  It can store these colors in the picture's
  96.    comment so they can be used next time you view the same picture to get
  97.    very high quality pictures (especially when used in conjunction with the
  98.    @{"DITHER" link Dither} option).
  99.  - Fast conversion to HAM/HAM8.
  100.  - FastView can save your pictures as IFF files (press 'S' while viewing
  101.    a picture).
  102.  - Uses its own BestModeID code which tries to pick the best mode for
  103.    each picture.  The behaviour of this function can be fully controlled
  104.    using the @{"SCREENMODE" link ScreenMode} option.
  105.  - Can be used for a simple slideshow.
  106.  - @{"Keyboard" link Keyboard} can be used to scroll picture (or the mouse of course).
  107.  - Programmed in highly optimized Assembler (less than 25K in size!).
  108. @endnode
  109. @node Requirements "FastView: System requirements"
  110. FastView should run on any Amiga system with at least 512K RAM
  111. and Kickstart 2.04 or higher.
  112. FastView is Kickstart 3.0 compatible and aware.  It will use some
  113. V39 functions when available.
  114. Should you have any trouble running FastView on your machine, please
  115. @{"contact me" link About} with the full specifications of your machine,
  116. that is Kickstart version, model, expansion boards etc...  Don't
  117. forget to mention which version of FastView you were using at the
  118. time.
  119. @endnode
  120. @node Registration "Registration: How to register FastView"
  121. This program is shareware, it is *not* public domain.  This means
  122. that if you use this program longer than a period of two weeks
  123. you'll have to send @{"The author" link About} 20 DM, HFL 20, 10 UK Pounds
  124. or 15 US Dollars to become a registered user.
  125. Please only send cash, eurocheques or postal money orders.
  126. When sending cash only use bank-notes (no coins!) and put it
  127. between two blank pieces of paper to avoid it from being detected
  128. on the way.  This is probably the easiest and cheapest way.
  129. Eurocheques and postal money orders should be in Dutch Guilders
  130. (HFL) only, since otherwise I won't be able to cash them without
  131. paying a considerable fee to the bank (and that is the last thing
  132. we'd want).
  133. You can send the registration fee to the following address:
  134.         Until 31 April 1996:
  135.             John Hendrikx
  136.             Figarostraat 36
  137.             3208 PD  Spijkenisse
  138.             The Netherlands
  139.         After 31 April 1996:
  140.             John Hendrikx
  141.             Maasboulevard 74
  142.             3207 RC  Spijkenisse
  143.             The Netherlands
  144. @endnode
  145. @node About "FastView: About the author and the program"
  146. FastView has been created using the Devpac Assembler and CygnusED
  147. on an Amiga 2000 with a 68030/22 and 7 MB of memory.  The source
  148. code (in 100% Assembler) for FastView is now over 150K in size.
  149. If you have suggestions or remarks about this program, or if you find
  150. any bugs, please let me know.
  151. When sending in bug reports, please state exactly under what
  152. circumstances the bug occurred, what equipment was used and what
  153. happened.  If possible also try to give me enough information to
  154. reproduce the bug (like the picture file which caused the bug).
  155. It is very difficult to find bugs when you don't know exactly
  156. what happened.  Don't forget to mention which version of FastView
  157. you were using at the time.
  158. Write to one of the following addresses:
  159.         UUCP     : john.hendrikx@grafix.xs4all.nl
  160.         Fido     : 2:286/407.8
  161.         AmigaNet : 39:153/201.8
  162.         NLA Net  : 14:101/200.8
  163.        Snail Mail until 31 April 1996:
  164.                    John Hendrikx
  165.                    Figarostraat 36
  166.                    3208 PD  Spijkenisse
  167.                    The Netherlands
  168.        Snail Mail after 31 April 1996:
  169.                    John Hendrikx
  170.                    Maasboulevard 74
  171.                    3207 RC  Spijkenisse
  172.                    The Netherlands
  173. I will also try to put the latest available version of FastView on
  174. the following BBS (this may change without further notice):
  175.         Grafix Attack (Kees Huizer, Vlaardingen)
  176.         Tel. +31104745816 (MT 14K4)
  177.              +31104741062 (ZyXEL 19K2)
  178.              +31104744682 (Tron 28K8)
  179.         Fido Node  2:286/407
  180.         AmyNet    39:153/201
  181.         NLA Node  14:101/200
  182. @endnode
  183. @node UsageWB "FastView: Usage from Workbench"
  184. There are 3 ways to use FastView from the Workbench:
  185. 1) Simply double-click on the FastView icon and it will come up with a
  186.    File requester which allows you to select the pictures you want to
  187.    view.  You may select multiple pictures by holding down shift during
  188.    selection.  If you don't select any pictures then FastView will
  189.    assume you want to view the entire dir.
  190. 2) You can view pictures by using extended selection: Select the
  191.    FastView icon and select, while holding down the shift key, the
  192.    pictures you want to view.  Double-click (while still holding down
  193.    shift) on the last picture you want to view to start FastView.
  194. 3) You may use FastView as the Default Tool for your pictures.  To set
  195.    the Default Tool to FastView for a picture, simply select the
  196.    picture's icon and choose Information from the Icons menu in Workbench.
  197.    Set the Default Tool field to 'FastView' (make sure it is located in
  198.    your search path!) and save this setting.  Now you can simply
  199.    double-click on the picture to view it with FastView.  Selecting
  200.    multiple pictures is also possible, as long as the last picture
  201.    you've selected has the Default Tool set to FastView.
  202. The FastView icon can have several Tool Types which control the
  203. way FastView operates.  Most of these Tool Types work similar
  204. compared with their Shell counterparts.  Here are the available
  205. Tool Types which also are available in the Shell plus a short
  206. description:
  207.  @{"COMMAND" link Command}      The command FastView will execute when the Tab key is pressed
  208.  @{"DITHER" link Dither}       Uses dithering to increase the picture quality
  209.  @{"FORCEAGA" link ForceAGA}     Makes FastView think you have AGA (handy for Retina)
  210.  @{"INFO" link Info}         Line with name and size of the picture at top of screen
  211.  @{"LEAVEMEM" link LeaveMem}     The number of kilobytes of memory FastView should leave free
  212.  @{"MAKECOMMENT" link MakeComment}  Creates a special comment to enhance picture quality
  213.  @{"NOLACE" link NoLace}       Avoids interlaced screens
  214.  @{"POINTER" link Pointer}      Pointer won't be blanked when picture is complete
  215.  @{"PUBSCREEN" link PubScreen}    Specifies on which Public Screen file requesters appear
  216.  @{"ROM" link Rom}          Uses WritePixelLine8() in ROM for graphics card support
  217.  @{"SCALE" link Scale}        Scales the picture down to fit it on the screen
  218.  @{"SCREENMODE" link ScreenMode}   Allows accurate control of what screen modes to use
  219.  @{"SLOWSWITCH" link SlowSwitch}   Smoother transitions for slideshows
  220.  @{"USECHIP" link UseChip}      Allows FastView to use Chip RAM for pre-loading pictures 
  221.  @{"WAITFORPIC" link WaitForPic}   Waits until a picture is fully decoded
  222. There is also one Workbench specific Tool Type:
  223.  DEFAULTDIR
  224. This Tool Type allows you to set the directory which FastView will
  225. list in the File Requester when you start FastView by simply
  226. double-clicking on it (Method 1, see above).
  227. @endnode
  228. @node UsageCLI "FastView: Usage from the Shell"
  229. There is nothing to it really.  Just start it from the Shell or install
  230. it in your favourite directory utility.
  231. The command line looks like this:
  232.  @{"FILES/M" link Files},@{"DITHER/S" link Dither},@{"NOLACE/S" link NoLace},@{"SCALE/S" link Scale},@{"DELAY/K/N" link Delay},@{"INFO/S" link Info},@{"WAITFORPIC/S" link WaitForPic},
  233.  @{"ROM/S" link Rom},@{"MAKECOMMENT/S" link MakeComment},@{"POINTER/S" link Pointer},@{"DEBUG/S" link Debug},@{"SM=SCREENMODE/K" link ScreenMode},
  234.  @{"LEAVEMEM/K/N" link LeaveMem},@{"USECHIP/S" link UseChip},@{"PUBSCREEN/K" link PubScreen},@{"FORCEAGA/S" link ForceAGA},@{"GRAY=GREY/S" link Gray},
  235.  @{"COMMAND/K" link Command},@{"SLOWSWITCH/S" link SlowSwitch}
  236. or alternatively:
  237.  [[FILES[=]]<string(s)>] [DITHER] [NOLACE] [SCALE] [DELAY[=]<number>]
  238.  [INFO] [WAITFORPIC] [ROM] [MAKECOMMENT] [POINTER] [DEBUG]
  239.  [(SM/SCREENMODE)[=]<string>] [LEAVEMEM[=]<number>] [USECHIP]
  240.  [PUBSCREEN[=]<string>] [FORCEAGA] [(GRAY/GREY)] [COMMAND[=]<string>]
  241.  [SLOWSWITCH]
  242. @endnode
  243. @node Files "FILES/M"
  244. FILES/M
  245. This argument is not required.  If you don't specify any files FastView
  246. will pop up a file requester where you can select which pictures you want
  247. to view.  You can use AmigaDOS patterns (wildcards) to make viewing
  248. multiple pictures easier.  You can add as many names/patterns on the
  249. command line as you want, and all pictures will be viewed in the order you
  250. specified.  (Note: Patterns matching multiple pictures will be shown in a
  251. somewhat random order).  In case you're viewing multiple pictures the
  252. right mouse button will act as an abort function, thus it will enable you
  253. to exit FastView completely at any time.  Left mouse button will continue
  254. to the next picture.
  255. @endnode
  256. @node Dither "DITHER/S"
  257. DITHER/S
  258. Specify this on the command line if you want to add a simple form of
  259. dithering to the (rerendered) pictures.  This will slow down FastView by
  260. about 50%.
  261. @endnode
  262. @node NoLace "NOLACE/S"
  263. NOLACE/S
  264. Specify this to make sure FastView doesn't use interlaced displays.
  265. @endnode
  266. @node Scale "SCALE/S"
  267. SCALE/S
  268. When you specify this on the command line FastView will scale down
  269. pictures so they will fit on your screen, while keeping the aspect ratio
  270. intact.  This works for all kinds of pictures, but may produce ugly
  271. results when used on HAM pictures.
  272. @endnode
  273. @node Delay "DELAY/K/N"
  274. DELAY/K/N
  275. Using this option you can turn FastView into a slideshow.  It allows you
  276. to set the number of seconds each picture will be displayed.  Note that
  277. FastView will automatically load the next picture in the background while
  278. you're still viewing the current picture, which makes slideshows look much
  279. better.
  280. @endnode
  281. @node Info "INFO/S"
  282. INFO/S
  283. Add this to the command line if you want the filename, size and depth of
  284. the picture you're viewing to be displayed at the top of the display.
  285. @endnode
  286. @node WaitForPic "WAITFORPIC/S"
  287. WAITFORPIC/S
  288. When used in conjunction with the DELAY keyword WAITFORPIC will ensure
  289. that the picture being decoded in the background is fully decoded before
  290. FastView switches to the next picture.  This should make slideshows look a
  291. bit better.
  292. @endnode
  293. @node Rom "ROM/S"
  294. ROM/S
  295. This will make FastView use ROM functions (WritePixelLine8) to draw the
  296. pictures instead of poking directly into the screen's bitmap.  Comments
  297. from graphics card users on this function are welcomed!  In the future
  298. I will probably use the RtgMaster.library system to provide support for
  299. a large amount of graphics cards.
  300. @endnode
  301. @node MakeComment "MAKECOMMENT/S"
  302. MAKECOMMENT/S
  303. If you specify this keyword FastView will automatically calculate the
  304. optimal palette for the pictures you're viewing and store this palette in
  305. the comment of those pictures.  Next time you view the picture FastView will
  306. use the palette stored in the comment which should ensure you get a bit
  307. higher quality pictures.  This only works for pictures which are displayed
  308. in either HAM6 or HAM8.
  309. @endnode
  310. @node Pointer "POINTER/S"
  311. POINTER/S
  312. Specify this on the command line if you don't want FastView to blank the
  313. mouse pointer after decoding the pictures.
  314. @endnode
  315. @node Debug "DEBUG/S"
  316. DEBUG/S
  317. If you have problems with FastView picking the wrong screen mode you might
  318. want to set this option and post me the results.  Using this option you get
  319. a list of all screen modes FastView considers to be good enough to display
  320. your picture.  The final line contains the screen mode FastView found to
  321. be the best available.
  322. @endnode
  323. @node ScreenMode "SM=SCREENMODE/K"
  324. SCREENMODE/K or SM/K
  325. People owning VGA monitors or owners of graphics cards may want
  326. to tell FastView which screen modes it is allowed to choose from
  327. when looking for the best screen mode to display a certain
  328. picture.  You can do this with the SCREENMODE option.  It accepts
  329. a string which specifies which screen mode(s) FastView may choose
  330. from.  This string may contain AmigaDOS patterns (wildcards) for
  331. maximum flexibility.  Examples:
  332.   SCREENMODE=DBL#?
  333. This will allow FastView only to pick DBLPAL or DBLNTSC modes (in
  334. other words screen modes that start with 'DBL'.)
  335.   SCREENMODE=~(#?low#?)
  336. Using this screen mode string FastView will never select any screen modes
  337. that contain the word 'low'.  This means modes like "PAL:Low Res"
  338. and "MULTISCAN:Extra-Low Res" won't be picked.
  339.   SCREENMODE=(PAL:|SUPER72:|DBLPAL:)#?
  340. This screen mode string will make sure FastView only selects PAL, DBLPAL
  341. or SUPER72 screen modes.
  342. @endnode
  343. @node PubScreen "PUBSCREEN/K"
  344. PUBSCREEN/K
  345. Using this you can tell FastView on which Public Screen it should open
  346. its file requesters.  For example, if you want FastView to open its
  347. file requesters on Directory Opus you can specify PUBSCREEN=DOPUS.1
  348. @endnode
  349. @node LeaveMem "LEAVEMEM/K/N"
  350. LEAVEMEM/K/N
  351. This allows you to tell FastView how much RAM it is NOT allowed to
  352. use for storing pictures which are being decoded while another
  353. picture is being displayed.  Specifying LEAVEMEM=1000 will ensure
  354. that there is always 1000K of RAM left.  The @{"USECHIP" link UseChip} option
  355. determines if this 1000K also includes Chip RAM.
  356. If you want to disable FastView's ability to preload and decode pictures
  357. just set this value to a value higher then the total amount of RAM in your
  358. system.
  359. @endnode
  360. @node UseChip "USECHIP/S"
  361. USECHIP/S
  362. Using this keyword you can tell FastView that it is okay to use
  363. Chip RAM for storing pictures which are being decoded while another
  364. picture is being displayed.  Since Chip RAM is essential for displaying
  365. pictures it is not wise to allow FastView to eat up available Chip RAM,
  366. but it might come in handy on machines with little or no Fast RAM.  If
  367. you intend to use this option be sure to take a look at the @{"LEAVEMEM" link LeaveMem}
  368. option as well.
  369. @endnode
  370. @node Command "COMMAND/K"
  371. COMMAND/K
  372. This allows you to control exactly what FastView will do when the Tab
  373. key is pressed.  If for example you want FastView to make a copy of
  374. the picture you are currently viewing to your RAM disk each time the
  375. Tab key is pressed then you could tell FastView this like this:
  376.  COMMAND="Copy %s to RAM:"
  377. %s will automatically get replaced by the filename of the picture
  378. you are currently viewing.  Now each time you press the Tab key
  379. FastView will copy the picture to your Ram Disk.  This could for
  380. example come in handy when you want to select a view pictures
  381. from a CD-ROM.
  382. @endnode
  383. @node ForceAGA "FORCEAGA/S"
  384. FORCEAGA/S
  385. This is a special keyword most people will never need.  It makes
  386. FastView think that the machine it is running on is an AGA machine
  387. without checking to see if that actually is true.  This can come
  388. in handy for people who own a graphics card (Retina for example)
  389. which are able to display the HAM8 mode found in AGA.
  390. Note: This keyword has not yet been properly implemented yet, use
  391.       at your own risk!
  392. @endnode
  393. @node Gray "GRAY=GREY/S"
  394. GRAY=GREY/S
  395. Using this you can force FastView to render pictures normally
  396. rendered in HAM or HAM8 to be rendered in gray-scales.  This can
  397. result in more detailed pictures and a lot faster rendering.
  398. This option can also be used in conjunction with the @{"DITHER" link Dither} option
  399. to increase the quality of the gray-scale rendering.
  400. Note: Only pictures which normally cannot be displayed directly
  401.       on your system will be converted to grayscale pictures,
  402.       all other pictures will still be in color.
  403. @endnode
  404. @node Gray "SLOWSWITCH/S"
  405. SLOWSWITCH/S
  406. This option is handy for slideshows.  It will tell FastView to first
  407. decode the next picture on a screen in the background before displaying
  408. it.  This gives smoother transistions between pictures.
  409. @endnode
  410. @node Config "FastView: How to configure it"
  411. From version 2.0 FastView allows you to specify default options
  412. in a config file.  The structure of such a config file is the
  413. same as what you normally would enter on the commandline in the
  414. Shell.  If for example you would like FastView to always dither and
  415. scale your pictures then your configfile could look like this:
  416. "DITHER SCALE".
  417. There are three places where FastView looks for a config file.
  418. First it checks for and environment variable called FastView (in
  419. other words FastView looks into the "ENV:" directory for the file
  420. "FastView"), if that fails it checks the directory FastView is
  421. located in for the file "FastView.prefs" and if that fails as
  422. well it will check "S:FastView.prefs".
  423. To set or change the environment variable FastView you can use
  424. the SetEnv command in the Shell.  For example to set the FastView
  425. environment variable to dithering and scaling you should enter:
  426.   SetEnv FastView "CONFIG SCALE"
  427. and to make the change permanent you then should type:
  428.   Copy ENV:FastView ENVARC:
  429. If you don't want to use an environment variable then you can create
  430. a file called "FastView.prefs" similar to the environment variable.
  431. You should put this file either in the directory FastView is located
  432. in (PROGDIR:) or in the S: directory.
  433. @endnode
  434. @node Keyboard "FastView: Keyboard control while viewing pictures"
  435. FastView provides some simple keyboard shortcuts while viewing
  436. pictures so you are able to scroll the screen and skip to the
  437. next picture without using the mouse.
  438. You can use the cursor keys or the numeric keypad to scroll the picture.
  439. FastView normally uses steps of 16 pixels to scroll the picture, but
  440. by holding down the Alt key or the Shift key will cause FastView to
  441. use four times as small or as large steps respectively.
  442. The other keys are:
  443.  Space, Return or Enter - Proceed to next picture.
  444.                     Esc - Exit FastView completely.
  445.                       S - Pops up a Save requester which allows you to
  446.                           save the screen as an IFF file.
  447.               Shift-Del - Deletes the picture you are viewing and
  448.                           proceeds to the next picture.
  449.                     Tab - Execute the command which you can specify
  450.                           with the @{"COMMAND" link Command} option.
  451. @endnode
  452. @node Future "FastView: Future"
  453. Here is a list of things I want to add to FastView later:
  454.  - Support for the IFF PBM format produced by DPaint 2 enhanced
  455.    (pc version)
  456.  - Support for the new PNG format
  457.  - Using a file with a list of pictures as input
  458. If you have suggestions for new features which you think would be
  459. nice to have in FastView, don't hesitate to contact me.
  460. @endnode
  461. @node Bugs "FastView: Known bugs"
  462. While you're viewing a picture and you switch back to another screen the
  463. FastView screen/window will get deactivated which will break the Delay
  464. function.  This is because FastView won't receive IntuiTicks messages
  465. from Intuition while its window is deactivated, and so can't tell when
  466. the Delay time is over.
  467. @endnode
  468. @node History "FastView: History"
  469. Aug 20 1994 - V0.90 - Added GIF decoding
  470. Aug 24 1994 - V0.91 - Speeded up HAM conversion routine by almost 20%;
  471.                       Speeded GIF conversion by about 5%; LMB now also
  472.                       exits the viewer when displaying a GIF
  473. Aug 25 1994 - V0.92 - Handles interlaced GIFs; Uses LoRes HAM if picture
  474.                       is smaller than 320x256; Displays B&W pictures in
  475.                       Hires 16 colors instead of HAM
  476. Aug 26 1994 - V0.93 - Almost doubled IFF displaying speed thanks to the
  477.                       BackFill-Hooks (Other picture types will also
  478.                       benefit from this)
  479. Aug 27 1994 - V0.94 - Displays uncompressed IFFs
  480. Aug 31 1994 - V0.95 - Finally figured out how to convert HAM8 to 24Bit
  481.                       (it turned out IFF-HAM8 has its control-bits as
  482.                       bit 6 and 7...); Added Dithering for pictures
  483.                       which are converted to HAM or B&W
  484.               V0.96 - Now outputs info about the picture; Possible to
  485.                       specify multiple pictures on command line and RMB
  486.                       now exits completely when viewing multiple
  487.                       pictures; Uses BusyPtr while decoding; Blanks
  488.                       mouse after decoding
  489.               V0.97 - Added IFF 24bit decoding using fixed HAM palette;
  490.                       Also added NOINTERLACE command line option
  491. Sep  5 1994 - V0.98 - Added variable (down) scaling; Now centers picture
  492.                       if it is too small (this avoids the trash at the
  493.                       right-edge due to Hardware limitations)
  494. Sep  8 1994 - V0.99 - No longer crashes when a BadCode is encountered
  495.                       in a GIF file
  496. Sep 16 1994 - V0.99 - Fixed color-selecting algorithm -- it now does
  497.                       very good color-selecting
  498. Sep 17 1994 - V1.00 - Added AGA support (hopefully) and made it Kick2.04
  499.                       compatible
  500. Sep 18 1994 - V1.01 - Added intelligent ViewMode selection if CAMG chunk
  501.                       is missing from an IFF file
  502. Sep 19 1994 - V1.02 - Fixed small bug which caused uncompressed HAM8
  503.                       pictures not to be displayed
  504. Sep 20 1994 - V1.03 - Fixed problem with IFF pictures which weren't
  505.                       exactly the same width as the screen; Added
  506.                       rendering to HAM8 for AGA machines
  507. Sep 25 1994 - V1.04 - Fixed Enforcer hit when no palette was found in
  508.                       picture; Added Wildcard support
  509. Sep 29 1994 - V1.05 - Fixed LoadRGB4 code; Fixed bugs in Wildcard
  510.                       support which caused memory freed twice errors;
  511.                       Fixed HAM8 support
  512. Oct  3 1994 - V1.06 - Added simple local-colormap handling code to GIF
  513.                       decoder; When initial codesize was too small or
  514.                       too big GIF decoder crashed, bug fixed
  515. Oct  4 1994 - V1.07 - Added Delay keyword; Added keyboard support while
  516.                       viewing/decoding picture
  517. Oct 12 1994 - V1.08 - FastView now automatically loads and decodes the next
  518.                       picture in the background for nicer slideshows and
  519.                       faster viewing; Fixed small bugs which caused
  520.                       small uncompressed IFF files to be displayed
  521.                       incorrectly
  522. Oct 14 1994 - V1.09 - Finally IFF24->HAM8 works; Removed some more bugs
  523. Oct 20 1994 - V1.10 - Added file requester
  524. Nov 14 1994 - V1.11 - Fixed enforcer hit (reported by: Richard Hartmann)
  525. Nov 24 1994 - V1.13 - RGB to HAM/HAM8 conversion now 10% faster
  526. Nov 25 1994 - V1.14 - Sometimes crashed when running low on Chip RAM when
  527.                       viewing large pictures -- fixed
  528.               V1.15 - Uses BestModeID under V39+ to pick the best display
  529.                       type; Added INFO switch on command line which will
  530.                       print the name of the picture at the top of screen
  531.               V1.16 - Separate 68000 and 68020 versions available
  532. Nov 28 1994 - V1.17 - Fixed bug causing excessive HAM-fringing effects
  533.                       while viewing HAM8 pictures (reported by: Edmund
  534.                       Vermeulen)
  535. Dec  1 1994 - V1.18 - Fixed bug causing excessive HAM-fringing effects
  536.                       on Kickstart 2.0 (reported by: Remco van Hooff);
  537.                       Fixed bug with ASL requester causing the CurrentDir
  538.                       of the Shell it was started from to be modified
  539.                       (reported by: Jan van den Baard); Fixed bug
  540.                       causing interlaced-GIF's to be screwed up while
  541.                       using the INFO switch (reported by: Martijn
  542.                       Hoogesteger); Fixed INFO-text color-pick bug
  543.               V1.19 - DELAY was ignored when there was no memory for
  544.                       the 2nd screen -- fixed (reported by: Arthur
  545.                       Pijpers)
  546. Dec  6 1994 - V1.20 - Fixed bug in IFF decoder when multiple FORM's are
  547.                       encountered in an IFF file (reported by: Jan van
  548.                       den Baard)
  549.               V1.21 - Added 'WaitForPic' option.  When using the delay
  550.                       option to create a slideshow, WaitForPic will make
  551.                       sure the picture in the background is ready before
  552.                       switching to that picture (requested by: Arthur
  553.                       Pijpers)
  554. Dec  8 1994 - V1.22 - Fixed bug with GIF's containing a local colormap.
  555.                       This bug crept in in V1.13 (reported by: Arthur
  556.                       Pijpers)
  557. Dec 22 1994 - V1.23 - Fixed bug which a division by zero by BestModeIDA().
  558.               V1.24 - FastView now correctly skips the masking bitplane
  559.                       sometimes found in IFF files.
  560. Dec 31 1994 - V1.25 - Small bug fixed created by 1.24, FastView
  561.                       accidentaly treated pictures with a transparent
  562.                       color as pictures with a mask.
  563. Jan  4 1995 - V1.26 - Fixed aspect ratio when using BestModeID().
  564. Jan  9 1995 - V1.27 - Added JPEG support using the Tower JPEG Codec Class
  565.                       by Christoph Feck.
  566. Jan 22 1995 - V1.28 - Added a command line switch to disable BestModeID.
  567.                       Also fixed a problem with WShell.  Names which are
  568.                       too long to display above the picture are shortened.
  569.               V1.29 - Significantly improved quality of pictures rendered
  570.                       in HAM6 and HAM8.
  571. Jan 23 1995 - V1.30 - Added GrayScale support for JPEG pictures.
  572. Feb 28 1995 - V1.31 - FastView can now store color information of the
  573.                       picture in the comment.  The 2nd time the same
  574.                       picture is viewed it will look better due to the
  575.                       precalculated colors
  576. Mar  2 1995 - V1.32 - ASL requester now uses a bit more normal values
  577.                       for its initial window-size (requested by: Edmund
  578.                       Vermeulen); FastView now checks if the user
  579.                       specified a path, and copies this in the path field
  580.                       of the requester (requested by: Edmund Vermeulen);
  581.                       Added an option to not blank the mouse
  582. Mar  5 1995 - V1.33 - Hopefully improved BestModeID code a bit; Added a
  583.                       IFF saving routine (requested by: Benbuck Nason)
  584. Mar 16 1995 - V1.34 - FastView now has an icon (thanks to Edmund
  585.                       Vermeulen) and can be started from Workbench.
  586.                       Several Tool Types are supported to help control
  587.                       FastView from the Workbench
  588. Apr 14 1995 - V1.35 - Multiselecting FastView plus some pictures will now
  589.                       cause FastView to display the selected pictures
  590.                       (requested by: Edmund Vermeulen); FastView now has
  591.                       an install script (thanks to Edmund Vermeulen)
  592.               V1.36 - FastView now pops up the file requester again after
  593.                       viewing some pictures (requested by: Edmund
  594.                       Vermeulen)
  595.               V1.37 - When using the ROM option FastView now uses
  596.                       WritePixelLine8() instead of WritePixel()
  597. Apr 16 1995 - V1.38 - Fixed several sneaky bugs which could cause trash
  598.                       at the right-border of a picture
  599. Apr 18 1995 - V1.39 - FastView now supports 2, 16 and 256 color
  600.                       (uncompressed) BMP pictures as well as 24-bit BMP
  601.                       pictures
  602.               V1.40 - FastView now supports EGA and VGA PCX files; Fixed
  603.                       small bug causing B&W JPEG pictures to be trashed
  604.                       on AGA
  605. Apr 21 1995 - V1.41 - Added ROM and WAITFORPIC Tool Types; Fixed bug which
  606.                       caused a crash when a picture is too big to
  607.                       display; When using Delay and WaitForPic FastView
  608.                       didn't exit after showing you the last picture
  609. May  2 1995 - V1.42 - Some pictures weren't saved correctly under AGA,
  610.                       fixed; Fixed enforcer hit when passing NULL as the
  611.                       path for the ASL requester under V40 (works fine
  612.                       for V39 and earlier)
  613. May  4 1995 - V1.43 - Added DEBUG option; When you select no files in
  614.                       the ASL requester FastView assumes you want to view
  615.                       the entire directory
  616. May  5 1995 - V1.44 - Specifying MULTISAVE on the commandline together
  617.                       with SAVE will save all pictures viewed as IFF
  618.                       pictures using the name you specified after SAVE as
  619.                       the extension
  620. May 18 1995 - V1.45 - Removed a bug in the 68000 version of FastView which
  621.                       caused some GIF pictures to be trashed; FastView no
  622.                       longers specifies Workbench as the public screen to
  623.                       pop-up on
  624.               V1.46 - FastView now uses a custom routine to replace
  625.                       BestModeID.  This routine will hopefully work correct
  626.                       with graphics cards and/or Kick 2.0; Added SCREENMODE
  627.                       keyword which allows you to specify the name of the
  628.                       monitor you wish to use (supports AmigaDOS patterns)
  629. May 19 1995 - V1.47 - Fixed some problems with my new BestModeID code, and
  630.                       added a SCREENMODE Tool Type; Added DEFAULTDIR Tool
  631.                       Type
  632. May 25 1995 - V1.48 - Fixed stupid bug causing an enforcer hit
  633. May 26 1995 - V1.49 - Fixed bug causing crashes when exiting FastView which
  634.                       was started from Workbench; Fastview now checks for
  635.                       Ctrl-C and exits when it receives one
  636. May 30 1995 - V1.50 - Fixed bug, ROM Tool Type now works; Fixed bug which
  637.                       caused some pictures to be saved wrong; Fixed bug
  638.                       which caused pictures to be saved with wrong palette
  639. Jun  3 1995 - V1.51 - No longer picks graphics card screen modes for HAM
  640.                       pictures; FastView now will run without monitor
  641.                       drivers (previously you had to use the NBMI option)
  642. Jun  5 1995 - V1.52 - POINTER option crashed on Kick2.0 machines because it
  643.                       used a V39 function, fixed
  644. Jun 16 1995 - V1.53 - Fixed a bug in the BMP code
  645. Aug  7 1995 - V1.90 - FastView now correctly handles GIF pictures without
  646.                       a global color-palette
  647. Aug 31 1995 - V1.91 - If screen couldn't be closed (because some utility
  648.                       has opened a window on it) then FastView will wait
  649.                       until the window removes itself before closing the
  650.                       screen; FastView now supports a config file or ENV:
  651.                       variable; Added FORCEAGA keyword for use with some
  652.                       graphics cards (Retina in particular).  It will make
  653.                       FastView think you have an AGA machine and will make
  654.                       it utilize modes like HAM8 and 256 colors
  655. Sep  1 1995 - V1.92 - Added GRAY/GREY option to tell FastView to render the
  656.                       picture in gray-scale instead of HAM
  657. Sep  2 1995 - V1.93 - Added COMMAND option which allows you to define an
  658.                       action to perform on a picture-file when you press
  659.                       the TAB key while viewing the picture; Pressing
  660.                       Shift + DEL will delete the picture you're currently
  661.                       viewing; Numeric keypad now also allows you to scroll
  662.                       diagonally
  663. Sep  8 1995 - V1.94 - Deleting the last file you wanted to view now works
  664.                       correctly; The correct path is now used when deleting
  665.                       files; CloseScreen() crashes under Kick 3.0 when
  666.                       closing a screen just 1 pixel high, as a work-around
  667.                       FastView never opens screens less than 8 pixels high;
  668.                       Improved COMMAND option allowing for very long and
  669.                       complex command-strings
  670. Sep 19 1995 - V1.95 - Gray-scale JPEGs work correctly on AGA and ECS again;
  671.                       Added SLOWSWITCH keyword
  672. Oct 10 1995 - V1.96 - Improved PCX support and removed some bugs from the
  673.                       PCX EGA palette code; Scaling has become 20% faster
  674. Oct 17 1995 - V1.97 - GREY option now works correctly for JPEGs on AGA;
  675.                       Environment variable was not correctly parsed, fixed
  676. Oct 24 1995 - V2.0 Public release
  677. @endnode
  678. @node Ack "FastView: Acknowledgments"
  679. Thanks to all who registered so far:
  680.   Folkert de Gans           
  681. yvind Falch              Dennis Eijs
  682.   Vincent Zee               Glenn J. Shutts           Harald Schilling
  683.   Martijn Hoogesteger       Bill Bennett              Bob Johnson
  684.   R. Veenman                Stephan Lichtendahl       Rick Yeomans
  685.   Tom de Ruyter             Robert Guezen             Torsten Jung
  686.   Henk Siemer               Romen Patzner             Jen Allen
  687.   Jon B. Peterson           Luca Saturno              Michael Luck
  688. Thanks to Michael Zucchi for creating ZGif which inspired me to write
  689. this program!
  690. Thanks to Edmund Vermeulen for the installer script and the
  691. FastView icon.
  692. Thanks to Romen Patzner for creating a nice MagicWB icon for FastView.
  693. Thanks to Jan van den Baard, Paul Dossett, Richard Hartmann,
  694. Remco van Hooff, Martijn Hoogesteger, Jim McKinney, Benbuck
  695. Nason, Raymond Penners, Arthur Pijpers, Romen Patzner, Maarten
  696. Ploeg, Edmund Vermeulen, Richard de Vos and Vincent Zee for bug
  697. reports and suggestions!
  698. Thanks to Christoph Feck for creating the Tower JPEG Codec Class which
  699. made it very easy for me to add JPEG support in FastView!
  700.              _
  701.           _ //
  702. Thanks to \\X/ Amiga for being the best computer ever!
  703. @endnode
  704. @node Problems "FastView: Frequently asked questions and their answers"
  705. Problem:  FastView sometimes screws up the screen (screen starts
  706. jumping or becomes black) but when I exit FastView everything
  707. returns to normal.
  708. Cause:  FastView tries to pick the best screen mode for displaying
  709. each picture.  It checks all screen modes available to find the
  710. best one and uses that.  If you happen to have some monitor
  711. drivers installed which are not suited for your system then
  712. FastView will sometimes not display the picture correctly when it
  713. chooses a monitor which your computer or monitor can't handle.
  714. Solution:  Remove all monitor drivers which your system can't
  715. handle from the DEVS:Monitors directory.  Another solution is to
  716. use the SCREENMODE keyword to make sure FastView never picks
  717. monitors which your system can't display.  I wouldn't recommend
  718. this last solution, you shouldn't have monitors in the
  719. DEVS:Monitors directory which your system can't handle, period.
  720. Problem:  FastView won't show JPEG pictures.
  721. Cause:  The JPEG codec class was not installed properly on your system.
  722. Solution:  Use the installer script to install FastView again, or
  723. install the JPEG codec class manually.  See @{"installation" link Install}.
  724. @endnode
  725. @node Install "FastView: Installation"
  726. To install FastView simply double-click the Install icon in the FastView
  727. drawer.
  728. If you want to install FastView manually then follow these steps:
  729.  1) Copy FastView and its icon to a directory in your path.  SYS:Utilities
  730.     is a good place to put it.  Make sure that you pick the version of
  731.     FastView best suited for your machine.  The 68020 version of FastView
  732.     can sometimes be significantly faster on 68020+ equipped machines.
  733. The next five steps are optional, and only needed if you also want to
  734. use FastView to view JPEG pictures.
  735.  2) Copy "Libs/tower.library" to your LIBS: directory.
  736.  3) Copy "Classes/codec.class" to your SYS:Classes directory, or to
  737.     your LIBS: directory.  If you're not using a standard C= installed
  738.     Startup-sequence then make sure that SYS:Classes is part of the
  739.     LIBS: assign.
  740.  4) Make a new directory "Codecs" in SYS:Classes or in the LIBS:
  741.     directory.
  742.  5) Copy "Classes/Codecs/jpeg.codec" to the SYS:Classes/Codecs directory,
  743.     or to the LIBS:Codecs directory (depending on where you create the
  744.     Codecs directory).
  745.  6) Copy "Classes/Codecs/picture.codec" to the SYS:Classes/Codecs
  746.     directory or to the LIBS:Codecs directory (depending on where you
  747.     create the Codecs directory).
  748. Done, you can now use FastView!
  749. @endnode
  750.